home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-1.iso / comm / bgfax155.zip / WAFFLE.TXT < prev    next >
Text File  |  1995-08-12  |  12KB  |  322 lines
  1. By:     Gregory Youngblood     zeta@tcscs.com           707-489-7500
  2. Of:     The Complete Solution BBS       Data/Fax:       707-459-9058
  3. Date:   9/14/93; Revision 2
  4. Date:   9/13/93; Revision 1
  5.  
  6. ************************* UPDATE for BG Fax 1.06 ****************************
  7. * BGFax 1.06 adds some new features.  Make sure to read the docs for the    *
  8. * new version along with these instructions to understand new options. The  *
  9. * marked changes to this file to reflect new features in 1.06 with a double *
  10. * astericks ("**").  If you have version 1.05 then you can ignore those     *
  11. * items, otherwise, make sure you include the updates for BGFax to work     *
  12. * with Waffle BBS.                                                          *
  13. *****************************************************************************
  14.  
  15.  
  16. This file explains how to set up BGFax to use with Waffle BBS.  The config
  17. file and batch files are slightly edited versions of batchfiles in use at
  18. The Complete Solution BBS.  This file covers BGFax 1.05.
  19.  
  20. Thanks goes to marc@mala.proteus.qc.ca for his configuration files from which
  21. I was able to expand upon.
  22.  
  23. Those who use Waffle as a BBS are used to the one letter commands that are
  24. used while the BBS of "Awaiting Call.." such as P for POLL and C for Chrome
  25. and so on.  Using BGFax to answer calls Waffle Sysops lose those letters.
  26. These instructions will maintain several of those functions while allowing
  27. your faxmodem to receive fax or data calls.  Best of all, your existing users
  28. won't see the modifications.
  29.  
  30. NOTE:   The MODEM init strings used in these configurations are for a Practical
  31. Peripherals PM14400FXMT (Rockwell based) fax/modem.  The base configuration
  32. has been stored in location 0 and can be retrieved with ATZ0 if I should 
  33. want to.  Instead I always init the modem starting with the factory defaults
  34. and make the needed changes for my tastes.  This way I've always got the
  35. changes if another misbehaved program changes my settings.
  36.  
  37. This works under OS/2 2.1 beta (3/93) and probably under 2.1 GA as well.  I
  38. also use Ray Gwinn's SIO/VSIO/VX00 package, version 1.02.  I found that 
  39. adding the line
  40.      RUN=C:\OS2\MODE.COM COM1:19200,N,8,1,,XON=OFF,IDSR=ON,ODSR=ON,OCTS=ON,
  41.          RTS=HS,DTR=ON,BUFFER=AUTO
  42. to the end of the CONFIG.SYS file helps out.  Note, this line should be on
  43. one line.  I had to split the line to fit in 80 columns.
  44.  
  45. I also recommend using BGFax in Front End mode since I had some problems 
  46. getting Waffle to recognize the +FCON message that my modem returns.
  47.  
  48. First, the BGFAX.CNF file:
  49.  
  50. ;Start BGFAX.CNF file
  51. ;--------------------------------------------------------------------------
  52. ;Basic Configuration
  53. ;COM1, set speed to 19200, choose QLII Fax documents, set incoming directory
  54. ;--------------------------------------------------------------------------
  55. po=1
  56. ft=Q
  57. sp=19200
  58. rp=d:\BGFAX\incoming
  59. ;** tc added in 1.06
  60. tc=ATH0
  61. ;--------------------------------------------------------------------------
  62. ;Init
  63. ;Displays CONNECT xxx where xxx is speed of caller, and some extra stuff for
  64. ;data callers.  Set FAX mode, set Fax Id to Data/Fax number, see BGFAX.DOC!
  65. ;--------------------------------------------------------------------------
  66. in=AT&F0e1l1m1w2&c1&d2&k3s0=0s11=70s46=2s95=3
  67. in=AT+FCR=1;+FLID="707-459-9058";+FDCC=1,5,0,2,0,0,0,0
  68. ;--------------------------------------------------------------------------
  69. ;Front End configuration
  70. ;Answer first ring with adaptive answering enabled.  If data call load BBS
  71. ;immediately.  Display BBS name if it displays anything.  Send /xxx in
  72. ;CONNECT 14400/xxx to batch file that calls BBS.  Accept all calls 300 bps
  73. ;and faster, allow Waffle to display call not accepted message if too slow.
  74. ;--------------------------------------------------------------------------
  75. ri=1
  76. an=AT+FAA=1;A
  77. do=<load>
  78. lo=The Complete Solution BBS
  79. ec=<echo>
  80. sl=300
  81. ts=Calls are not accepted below 300bps. 
  82. ;--------------------------------------------------------------------------
  83. ;Keys (ALT + letter exits with errorlevel
  84. ;S for local login
  85. ;X for exit
  86. ;C for Chrome
  87. ;P for Poll
  88. ;--------------------------------------------------------------------------
  89. ;**ky added in 1.06
  90. ky=C,244
  91. ky=S,245
  92. ky=P,246
  93. ky=X,0
  94. ;--------------------------------------------------------------------------
  95. ;Events (taken from Waffle's schedule)
  96. ;--------------------------------------------------------------------------
  97. ev=00:00,247
  98. ev=07:00,246
  99. ;--------------------------------------------------------------------------
  100. ;Fax Send Setup
  101. ;--------------------------------------------------------------------------
  102. si=AT&f0e1l1m1w2&c1&d2&k3s0=0s11=70s46=2s95=3
  103. si=AT+FLID="713 893 9124"
  104. ds=ATDT
  105. mb=3
  106. mf=3
  107.  
  108. ;End BGFAX.CNF file
  109.  
  110. Each setting is explained.  If more info is needed see the BGFAX.CNF file in
  111. the distribution file for BGFAX.
  112.  
  113. The port was set to 19,200 because I was having problems getting OS/2 to
  114. change port speeds from 57,600 down to 19,200 for faxes.  I will play with
  115. some other settings and such later, but for now this configuration works 
  116. fine.  I've received several faxes using this configuration already.
  117.  
  118. The next file is what I've called BBS.BAT.  This is what will replace RUN.BAT
  119. for Waffle.  I used a new batch file in case I needed to go back to a 
  120. known working RUN.BAT later on.  Make sure to note the WAF_MENU section as
  121. that is where you can put extra options. 
  122.  
  123. @echo off
  124. CLS
  125. :TOP
  126. BGFAX.EXE
  127. If ERRORLEVEL == 247 goto MAINT
  128. If ERRORLEVEL == 246 goto POLL
  129. REM ** Errorlevels for 245 and 244 added for new ALT-Key codes in 1.06
  130. IF ERRORLEVEL == 245 GOTO LOCAL
  131. IF ERRORLEVEL == 244 GOTO CHROME
  132. If ERRORLEVEL ==   4 goto FAX
  133. If ERRORLEVEL ==   3 goto WAF_MENU
  134. If ERRORLEVEL ==   2 goto WAFFLE
  135. If ERRORLEVEL ==   1 BBS.BAT
  136. Goto End
  137. :MAINT
  138. REM Run Door Maintenance
  139. call doormnt.bat
  140. REM Run ALLFILES listing
  141. call allfiles.bat
  142. REM Expire newsgroups
  143. call expire.bat
  144. REM Run VACATION
  145. call vacation.bat
  146. REM Run stats for term program to track LD costs
  147. call tmstats.bat 1
  148. REM Delay for 60 seconds to make sure that event doesn't get run again
  149. be delay 1080
  150. Goto TOP
  151. :POLL
  152. Rem Poll CCM for 10 minutes or until connection established
  153. call poll.bat ccm 10
  154. REM Delay for 60 seconds to make sure that event doesn't get run again
  155. be delay 1080
  156. Goto TOP
  157. :FAX
  158. call %BGFAX%\doprint.bat
  159. goto TOP
  160. :WAF_MENU
  161. REM USING a batch utility that allows single character input without pressing
  162. REM Return and then exits using ERRORLEVEL to determine choice.  This example
  163. REM uses BE.EXE from Norton Utils 6.  The options are virtually limitless, 
  164. REM I personally have 12, this example just lists 4.  C=Command.COM (my
  165. REM personal replacement for Chrome), P=POLL, S=Sysop Login, U=UUQ.
  166. type %BGFAX%\waf_menu.txt
  167. BE ASK "" CPSU Default=P
  168. IF ERRORLEVEL ==  4 GOTO UUQ
  169. IF ERRORLEVEL ==  3 GOTO LOCAL
  170. IF ERRORLEVEL ==  2 GOTO POLL
  171. IF ERRORLEVEL ==  1 GOTO CHROME
  172. Goto TOP
  173. :UUQ
  174. uuq.exe
  175. pause
  176. goto TOP
  177. :LOCAL
  178. call %BGFAX%\dobbs.bat LOCAL
  179. goto TOP
  180. :CHROME
  181. command.com
  182. goto TOP
  183. :WAFFLE
  184. call %BGFAX%\dobbs.bat
  185. :END
  186.  
  187. Since BGFAX uses RETURN to start the local login, I have put a sort of
  188. menu system in that gives me back some of the functionality of Waffle when
  189. it is waiting for a call.  Instead of starting the Waffle Local when 
  190. RETURN is pressed I display a menu, such as:
  191.         
  192.         The Complete Solution BBS             Interactive MENU 
  193.  
  194.         C       Command Shell           P       Poll Neighbor
  195.         S       Local Login             U       Query Outgoing
  196.  
  197. And then using some utility to read input and return an errorlevel I
  198. can launch any of these or anything else I might want to put in this menu.
  199.  
  200. ************************* UPDATE for BG Fax 1.06 ****************************
  201. * BGFAX 1.06 now supports exiting with errorcodes for ALT-Key combinations. *
  202. * The above example has been updated to work with 1.06 and still maintains  *
  203. * the use of the MENU system as described for 1.05.  Since 1.06 has this    *
  204. * new feature, then the RETURN key can be put back to local log in.  To     *
  205. * use the return key for local logins simply change the line which reads:   *
  206. * If ERRORLEVEL ==   3 goto WAF_MENU              --to--                    *
  207. * If ERRORLEVEL ==   3 goto LOCAL                                           *
  208. *****************************************************************************
  209.  
  210. The next file, EXEBBS.BAT could go in the BGFAX directory, but I wanted it in 
  211. my WAFFLE\BIN directory, so in BGFAX I put the folling as EXEBBS.BAT:
  212.         @echo off
  213.         call D:\BIN\EXEBBS.BAT %1 %2 %3 %4 %5 %6 %7 %8 %9
  214.  
  215. In EXEBBS.BAT (the real one) I have the following:
  216. @echo off
  217. IF "%1" == "LOCAL" WAFFLE LOCAL
  218. if not "%1" == "LOCAL" WAFFLE ONLINE %1
  219. IF ERRORLEVEL == 99 GOTO POLL
  220. If ERRORLEVEL == 75 GOTO TELEMATE
  221. If ERRORLEVEL == 42 GOTO ANONYMOUS
  222. If ERRORLEVEL == 40 GOTO UUCICO
  223. Goto End
  224. :POLL
  225. call poll.bat ccm 10
  226. goto End
  227. :TELEMATE
  228. C:
  229. cd \modem\telemate\tm
  230. tm.exe
  231. Goto END
  232. :Anonymous
  233. call UUANON
  234. goto END
  235. :UUCICO
  236. call UUSHELL
  237. goto END
  238. :END
  239. if EXIST D:\SPOOL\COMPRESS\*.* batch.exe
  240.  
  241. Since i have my WAFFLE system set up to allow me to run Telemate if I am
  242. logged in locally I have put the catch for that ERRORLEVEL in this batch 
  243. file.  Similarly, this is also the batch file that would catch errorlevels
  244. for UUCICO sessions.  The key here is to make sure it terminates.  This
  245. batch file should NOT start itself over or call itself.   Control needs
  246. to be returned to BBS.BAT so that the modem can be answered and faxes or
  247. data calls received.
  248.  
  249. The last little goody I've added is a mail notification batch file.  I 
  250. don't want to print incoming batch files automatically but I want a reminder
  251. that I've received a fax.  
  252.  
  253. In the BGFAX directory create a batch file called EXEPRINT.BAT, and in
  254. that batch file put the following:
  255.  
  256. @echo off
  257. rmail.exe -fFax-Daemon "-s%1" System < D:\BGFAX\INCOMING.MSG
  258.  
  259. and in INCOMING.MSG all I have is:
  260.  
  261. This fax was received today.
  262.  
  263. The subject line "-s%1" puts the fax filename in the subject of the message.
  264. This sends a message to System from the "fax-daemon" of your system telling
  265. your that your equipment received a fax.
  266.  
  267. In case the modem setup is important to you, this is what my modem is set
  268. to, and other useful/important information:
  269.  
  270. ati3
  271. PM14400FXMT [6R1] Version 2.17  (c) Practical Peripherals Inc., 1992, 1993.
  272.  
  273. OK
  274. at&v
  275.  
  276. ACTIVE PROFILE:            DTE:57600      DCE:1200      PARITY:NONE
  277. B16 B1 E1 L0 M0 N1 T Q0 V1 W2 X4 Y0 &A0 &B1 &C1 &D2 &G0 &J0 &K3 &L0 &Q9 &R0 &S0
  278. &T4 &U0 &X0 &Y0
  279. S00:000 S01:000 S02:043 S03:013 S04:010 S05:008 S06:002 S07:050 S08:002 S09:006
  280. S10:014 S11:070 S12:050 S18:000 S25:005 S26:001 S30:000 S36:007 S37:000 S38:002
  281. S43:005 S46:002 S48:007 S49:064 S50:220 S63:000 S82:128 S86:000 S95:003 S97:030
  282. S108:001 S109:062 S110:002 
  283. STORED PROFILE 0:
  284. B16 B1 E1 L0 M0 N1 T Q0 V1 W2 X4 Y0 &A0 &C1 &D2 &G0 &J0 &K3 &L0 &Q9 &R0 &S0 &T4
  285. S00:000 S02:043 S06:002 S07:050 S08:002 S09:006 S10:014 S11:070 S12:050 S18:000
  286. S25:005 S26:001 S30:000 S36:007 S37:000 S38:002 S46:002 S48:007 S63:000 S82:128
  287. S95:003 S97:030 S108:1 S109:062 S110:2 
  288. STORED PROFILE 1:
  289. B16 B1 E1 L0 M1 N1 P Q0 V1 W0 X4 Y0 &A0 &C1 &D3 &G0 &J0 &K3 &L0 &Q5 &R0 &S0 &T4
  290. S00:000 S02:043 S06:002 S07:050 S08:002 S09:006 S10:014 S11:095 S12:050 S18:000
  291. S25:005 S26:001 S30:000 S36:007 S37:000 S38:020 S46:002 S48:007 S63:000 S82:128
  292. S95:001 S97:030 S108:1 S109:062 S110:2 
  293. TELEPHONE NUMBERS:
  294. &Z0=                                    &Z1=
  295. &Z2=                                    &Z3=
  296.  
  297. OK
  298. ati4
  299. a097840F284C6703F
  300.  
  301. bC60004000
  302.  
  303. r1001111171012000
  304.  
  305. r3000111010000000
  306.  
  307. OK
  308. at+fclass=?
  309. 0,1,2
  310.  
  311. OK
  312.  
  313.  
  314. If you have any questions or problems about this information, send e-mail
  315. to Zeta@tcscs.com or call The Complete Solution BBS at 707-459-9058.  If
  316. you REALLY get into a bind, you can call me at the first phone number listed
  317. at the start of the instructions for Waffle BBS.  You may get a voice
  318. mailbox, if so, leave a message and I'll call you back.  Please don't 
  319. call me voice unless your having a problem with Waffle working with BGFAX.
  320. If you have problems with BGFAX contact the author using one of the methods
  321. in BGFAX.DOC.
  322.